---
title: Astro 사이트를 Microsoft Azure에 배포하세요
description: Microsoft Azure를 사용하여 Astro 사이트를 웹에 배포하는 방법.
type: deploy
i18nReady: true
---

[Azure](https://azure.microsoft.com/)는 Microsoft의 클라우드 플랫폼입니다. Microsoft Azure의 [Static Web Apps](https://aka.ms/staticwebapps) 서비스를 사용하여 Astro 사이트를 배포할 수 있습니다.

이 안내서에서는 Visual Studio Code를 사용하여 GitHub에 저장된 Astro 사이트를 배포하는 과정을 안내합니다. 다른 설정에 대해서는 [Azure Pipelines Task](https://learn.microsoft.com/en-us/azure/devops/pipelines/tasks/reference/azure-static-web-app-v0?view=azure-pipelines) 사용에 대한 Microsoft 안내서를 참조하세요.

## 전제 조건

이 안내서를 따르려면 다음이 필요합니다.

- Azure 계정 및 구독 키가 필요합니다. [여기에서 무료 Azure 계정](https://azure.microsoft.com/free)을 생성할 수 있습니다.
- [GitHub](https://github.com/)에 푸시된 앱 코드가 필요합니다.
- [Visual Studio Code](https://code.visualstudio.com/)의 [SWA 확장](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-azurestaticwebapps)이 필요합니다.

## 배포 방법

1. VS Code에서 프로젝트를 엽니다.

2. Static Web Apps 확장을 열고 Azure에 로그인한 후 **+** 버튼을 클릭하여 새 Static Web App을 만듭니다. 사용할 구독 키를 지정하라는 메시지가 표시됩니다.

3. 확장 프로그램에서 시작하는 마법사를 따라 앱 이름을 지정하고, 프레임워크 사전 설정을 선택하고, 앱 루트 (보통 `/`)와 빌드된 파일 위치 (`/dist` 사용)를 지정합니다. Astro는 Azure의 기본 제공 템플릿에 포함되어 있지 않으므로 `custom`을 선택해야 합니다. 마법사가 실행되고 저장소의 `.github` 폴더에 [GitHub Action](https://github.com/features/actions)이 생성됩니다. (이 폴더가 아직 존재하지 않는 경우 자동으로 생성됩니다.)

GitHub Action이 앱을 배포합니다 (GitHub 저장소의 Actions 탭에서 진행 상황을 확인할 수 있습니다). 성공적으로 완료되면 **Browse Website** 버튼을 클릭하여 SWA Extension의 진행률 창에 표시된 주소에서 앱을 볼 수 있습니다 (GitHub Action이 실행된 후에 표시됨).

## 알려진 문제

생성된 GitHub action yaml은 노드 14를 사용한다고 가정합니다. 이는 Astro 빌드가 실패함을 의미합니다. 이 문제를 해결하려면 프로젝트 package.json 파일을 이 코드로 업데이트하세요.

```
  "engines": {
    "node": ">=18.0.0"
  },
```

## 공식 자료

- [Microsoft Azure Static Web Apps 문서](https://learn.microsoft.com/en-us/azure/static-web-apps/)

## 커뮤니티 자료 

- [Astro 웹 사이트를 Azure Static Web Apps로 배포](https://www.blueboxes.co.uk/deploying-an-astro-website-to-azure-static-web-apps)
